﻿
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- saved from url=(0014)about:internet -->
<html xmlns:msxsl="urn:schemas-microsoft-com:xslt" xmlns:mssdk="winsdk" xmlns:script="urn:script" xmlns:build="urn:build" xmlns:MSHelp="http://msdn.microsoft.com/mshelp">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta name="Description" content="Enabling NDIS Debug Tracing By Setting Registry Values"/>
<meta name="MSHAttr" content="PreferredSiteName:MSDN"/>
<meta name="MSHAttr" content="PreferredLib:/library/windows/hardware"/>
<title>Enabling NDIS Debug Tracing By Setting Registry Values</title>

<meta name="MS-HAID" content="t11~0_ndis_ece22487-e22b-47c0-96a1-dc12e556397e.xml"/>


<link rel="STYLESHEET" type="text/css" HREF="../common/backsdk4.css"/>





<style>
html,div { margin: 0; padding: 0;}

body {
	padding: 0px;
	margin: 0px;
	overflow: auto;
	height: 100%;
}

#winchm_template_button{
	float: right;
	width: 93px;
	top: 7px;
	position: relative;
	text-align: right;
	right: 5px;
	height: auto;
}

#winchm_template_top{
	padding: 0px;
	margin: 0px;
	border-bottom: 1px solid #9B9B9B;
	background-color: #B1CEFE;
}

#winchm_template_navigation{
	margin: 0px;
	padding-top: 7px;
	padding-left: 7px;
	padding-bottom: 3px;
	padding-right: 0px;
	font-size: 8.5pt;
	font-family: Arial, Helvetica, sans-serif;
	font-weight: normal;
	color: #585858;
}

#winchm_template_title{
	margin: 0px;
	padding-top: 4px;
	padding-left: 7px;
	padding-bottom: 7px;
	padding-right: 0px;
	font-size: 18px; 
	font-family: Verdana, Geneva, sans-serif;
	color: #363636;
}

#winchm_template_content{
	margin-top: 20px;
	margin-left: 15px;
	margin-bottom: 20px;
	margin-right: 15px;
	width: auto  !important;
	width: 100%;
}

#winchm_template_footer{
	border-width: 1px;
	border-color: #B1CEFE;
	border-top-style: solid;
	margin-top: 15px;
	margin-left: 15px;
	margin-bottom: 20px;
	margin-right: 15px;
	padding-top: 7px;
	padding-left: 0px;
	padding-bottom: 0px;
	padding-right: 0px;
	font-family: arial, helvetica, sans-serif;
	font-size: 8.5pt;
	color: #696969;
	width: auto;
	text-align: left;
}


#winchm_template_container{
	margin: 0px;
	padding: 0px;
	position: static;
	padding-bottom: 3px;
	overflow: auto;
	background-color: #FFFFFF;
}


@media print
{
#winchm_template_container{
	position: static;	
	margin: 0px;
	padding: 5px;
	
	width: auto;
	height: auto;
	overflow: auto;
}
#winchm_template_button{
visibility:hidden;
}
}

#winchm_template_navigation A:link	{text-decoration: none; color:#004080}
#winchm_template_navigation A:visited  {text-decoration: none; color: #004080}
#winchm_template_navigation A:active {text-decoration: none; color: #004080 }
#winchm_template_navigation A:hover {text-decoration: none;color: #0080FF}

A:link	{text-decoration: underline; color:#0033CC}
A:visited  {text-decoration: underline; color: #0033CC}
A:active {text-decoration: underline; color: #0033CC }
A:hover {text-decoration: underline;color: #FF0000;}
</style>
<script type="text/javascript">
function isMobile(){
Agent = window.navigator.userAgent;
if (Agent.indexOf("iPhone")>=1 || Agent.indexOf("iPad")>=1 || Agent.indexOf("iPod")>=1 || Agent.indexOf("Android")>=1){
return true;
}else{
return false;	
}

}
function d_onresize(){
if (window.navigator.userAgent.indexOf("MSIE")>=1){
document.getElementById('winchm_template_container').style.pixelWidth = document.body.offsetWidth - 3;
document.getElementById('winchm_template_container').style.pixelHeight = document.body.offsetHeight - document.getElementById('winchm_template_top').offsetHeight - 4;
}
document.getElementById('winchm_template_container').style.top = document.getElementById('winchm_template_top').offsetHeight + 'px';
}

function d_onbeforeprint(){
document.getElementById('winchm_template_container').style.width = 'auto';
document.getElementById('winchm_template_container').style.height = 'auto';
}

function d_onafterprint(){
d_onresize();
}

if(!isMobile()){

window.onload = d_onresize;
window.onresize = d_onresize;
window.onbeforeprint = d_onbeforeprint;
window.onafterprint = d_onafterprint;

document.write("<style>\n");
document.write("body {overflow: hidden;}\n");
document.write("#winchm_template_container {position: absolute;overflow: auto;top : 0px;right: 0px;bottom: 0px;left: 0px;}\n");
document.write("</style>\n");
}

</script>
</head>
<body><script language="JavaScript" type="text/JavaScript">
function syn(){
if(parent.nav.tree){
 if(parent.nav.tree.loaded){
  parent.nav.tree.selectNode(1461);
 }else{
  setTimeout("syn()",500);
}
  }else{
  setTimeout("syn()",500);
  }}
if(parent!=self){
  setTimeout("syn()",100);
}else{
  parent.location.href = "../../index.htm?page=debugger/enabling_ndis_debug_tracing_by_setting_registry_values.htm";
}
originalOnload = window.onload;
if(originalOnload==null){
window.onload = function(){parent.contentLoaded = true;};
}else{
window.onload = function(){originalOnload();parent.contentLoaded = true;};
}
</script> 


<div id="winchm_template_top">
	<div id="winchm_template_button"><A href="enabling_ndis_debug_tracing.htm" title="Previous topic"><img id="winchm_template_prev" alt="Previous topic" src="../template2/btn_prev_n.gif" border="0"></a><A href="kernel_streaming_debugging.htm" title="Next topic"><img id="winchm_template_next" alt="Next topic" src="../template2/btn_next_n.gif" border="0"></a></div>
	<div id="winchm_template_navigation">Help &gt; 
<A href="introduction6.htm">Debugging Tools for Windows (WinDbg, KD, CDB, NTSD)</A> &gt; <A href="debugging_techniques.htm">Debugging Techniques</A> &gt; <A href="specialized_debugging_techniques.htm">Specialized Debugging Techniques</A> &gt; <A href="ndis_debugging.htm">NDIS Debugging</A> &gt; <A href="enabling_ndis_debug_tracing.htm">Enabling NDIS Debug Tracing</A> &gt; </div>
	<div id="winchm_template_title">Enabling NDIS Debug Tracing By Setting Registry Values</div>
</div>
<div id="winchm_template_container">
	<div id="winchm_template_content"><div id="mainSection"><p>You can enable different levels of debug tracing in various NDIS components by editing the registry. Typically, you should add the following entries and values to the <b>HKLM\SYSTEM\CurrentControlSet\Services\NDIS\Parameters</b> registry key:</p>
<div class="code"><span codelanguage=""><table>
<tr>
<th></th>
</tr>
<tr>
<td>
<pre>"DebugLevel"=dword:00000000
"DebugSystems"=dword:000030F3
"DebugBreakPoint"=dword:00000001 </pre>
</td>
</tr>
</table></span></div>
<p>The following values are acceptable for <b>DebugBreakPoint</b>, <b>DebugLevel</b> and <b>DebugSystems</b>:</p>
<p></p>
<dl>
<dt><a id="DebugBreakPoint"></a><a id="debugbreakpoint"></a><a id="DEBUGBREAKPOINT"></a><b>DebugBreakPoint</b></dt>
<dd>
<p>Controls whether an NDIS driver will automatically break into the debugger.  If this value is set to 1, NDIS will break into the debugger when a driver enters Ndis.sys's <b>DriverEntry</b> function.</p>
</dd>
<dt><a id="DebugLevel"></a><a id="debuglevel"></a><a id="DEBUGLEVEL"></a><b>DebugLevel</b></dt>
<dd>
<p>Selects the level or amount of debug tracing in the NDIS components that you select with the <b>DebugSystems</b> value.  The following values specify levels that you can select: </p>
<table>
<tr>
<th>Level</th>
<th>Description</th>
<th>Value</th>
</tr>
<tr>
<td>
<p>DBG_LEVEL_INFO</p>
</td>
<td>
<p>All available debug information. This is the highest level of trace.</p>
</td>
<td>
<p>0x00000000</p>
</td>
</tr>
<tr>
<td>
<p>DBG_LEVEL_LOG</p>
</td>
<td>
<p>Log information.</p>
</td>
<td>
<p>0x00000800</p>
</td>
</tr>
<tr>
<td>
<p>DBG_LEVEL_WARN</p>
</td>
<td>
<p>Warnings.</p>
</td>
<td>
<p>0x00001000</p>
</td>
</tr>
<tr>
<td>
<p>DBG_LEVEL_ERR</p>
</td>
<td>
<p>Errors.</p>
</td>
<td>
<p>0x00002000</p>
</td>
</tr>
<tr>
<td>
<p>DBG_LEVEL_FATAL</p>
</td>
<td>
<p>Fatal errors, which can cause the operating system to crash. This is the lowest level of trace.</p>
</td>
<td>
<p>0x00003000</p>
</td>
</tr>
</table>
<p> </p>
</dd>
<dt><a id="DebugSystems"></a><a id="debugsystems"></a><a id="DEBUGSYSTEMS"></a><b>DebugSystems</b></dt>
<dd>
<p>Enables debug tracing for specified NDIS components. This corresponds to using the <a href="#Bookmark2637"><b>!ndiskd.dbgsystems</b></a> extension.  The following values specify the NDIS components that you can select: </p>
<table>
<tr>
<th>Component</th>
<th>Description</th>
<th>Value</th>
</tr>
<tr>
<td>
<p>DBG_COMP_INIT</p>
</td>
<td>
<p>Handles adapter initialization.</p>
</td>
<td>
<p>0x00000001</p>
</td>
</tr>
<tr>
<td>
<p>DBG_COMP_CONFIG</p>
</td>
<td>
<p>Handles adapter configuration.</p>
</td>
<td>
<p>0x00000002</p>
</td>
</tr>
<tr>
<td>
<p>DBG_COMP_SEND</p>
</td>
<td>
<p>Handles sending data over the network.</p>
</td>
<td>
<p>0x00000004</p>
</td>
</tr>
<tr>
<td>
<p>DBG_COMP_RECV</p>
</td>
<td>
<p>Handles receiving data from the network.</p>
</td>
<td>
<p>0x00000008</p>
</td>
</tr>
<tr>
<td>
<p>DBG_COMP_PROTOCOL</p>
</td>
<td>
<p>Handles protocol operations.</p>
</td>
<td>
<p>0x00000010</p>
</td>
</tr>
<tr>
<td>
<p>DBG_COMP_BIND</p>
</td>
<td>
<p>Handles binding operations.</p>
</td>
<td>
<p>0x00000020</p>
</td>
</tr>
<tr>
<td>
<p>DBG_COMP_BUSINFO</p>
</td>
<td>
<p>Handles bus queries.</p>
</td>
<td>
<p>0x00000040</p>
</td>
</tr>
<tr>
<td>
<p>DBG_COMP_REG</p>
</td>
<td>
<p>Handles registry operations.</p>
</td>
<td>
<p>0x00000080</p>
</td>
</tr>
<tr>
<td>
<p>DBG_COMP_MEMORY</p>
</td>
<td>
<p>Handles memory management.</p>
</td>
<td>
<p>0x00000100</p>
</td>
</tr>
<tr>
<td>
<p>DBG_COMP_FILTER</p>
</td>
<td>
<p>Handles filter operations.</p>
</td>
<td>
<p>0x00000200</p>
</td>
</tr>
<tr>
<td>
<p>DBG_COMP_REQUEST</p>
</td>
<td>
<p>Handles requests.  </p>
</td>
<td>
<p>0x00000400</p>
</td>
</tr>
<tr>
<td>
<p>DBG_COMP_WORK_ITEM</p>
</td>
<td>
<p>Handles work-item operations.</p>
</td>
<td>
<p>0x00000800</p>
</td>
</tr>
<tr>
<td>
<p>DBG_COMP_PNP</p>
</td>
<td>
<p>Handles Plug and Play operations.</p>
</td>
<td>
<p>0x00001000</p>
</td>
</tr>
<tr>
<td>
<p>DBG_COMP_PM</p>
</td>
<td>
<p>Handles power management operations.</p>
</td>
<td>
<p>0x00002000</p>
</td>
</tr>
<tr>
<td>
<p>DBG_COMP_OPENREF</p>
</td>
<td>
<p>Handles operations that open reference objects.</p>
</td>
<td>
<p>0x00004000</p>
</td>
</tr>
<tr>
<td>
<p>DBG_COMP_LOCKS</p>
</td>
<td>
<p>Handles locking operations.</p>
</td>
<td>
<p>0x00008000</p>
</td>
</tr>
<tr>
<td>
<p>DBG_COMP_RESET</p>
</td>
<td>
<p>Handles resetting operations.</p>
</td>
<td>
<p>0x00010000</p>
</td>
</tr>
<tr>
<td>
<p>DBG_COMP_WMI</p>
</td>
<td>
<p>Handles Windows Management Instrumentation operations.</p>
</td>
<td>
<p>0x00020000</p>
</td>
</tr>
<tr>
<td>
<p>DBG_COMP_CO</p>
</td>
<td>
<p>Handles Connection-Oriented NDIS.</p>
</td>
<td>
<p>0x00040000</p>
</td>
</tr>
<tr>
<td>
<p>DBG_COMP_REF</p>
</td>
<td>
<p>Handles reference operations.</p>
</td>
<td>
<p>0x00080000</p>
</td>
</tr>
<tr>
<td>
<p>DBG_COMP_ALL</p>
</td>
<td>
<p>Handles all NDIS components.</p>
</td>
<td>
<p>0xFFFFFFFF</p>
</td>
</tr>
</table>
<p> </p>
<p>You can select more than one NDIS component. If more than one component is selected, combine the data values with an OR operator. For example, to select DBG_COMP_PNP, DBG_COMP_PM, DBG_COMP_INIT and DBG_COMP_CONFIG, you would combine the corresponding values (0x1000, 0x2000, 0x1, and 0x2) to obtain the value 0x3003, and then set it in the registry thus:</p>
<div class="code"><span codelanguage=""><table>
<tr>
<th></th>
</tr>
<tr>
<td>
<pre>"DebugSystems"=dword:00003003</pre>
</td>
</tr>
</table></span></div>
</dd>
</dl>
<p>Whenever you change registry values for debug tracing, you must restart your computer for the new settings to take effect.</p></div></div>	
	<div id="winchm_template_footer">Copyright &copy; 2019. All rights 
reserved. (To change the copyright info, just edit it in template.)</div>
</div>

</body>
</html>
